조각들
목차
분석 #
Congo는 기본적으로 다양한 분석 공급자를 지원하며, 또한 선택한 공급자에 대한 사용자 정의 코드를 포함할 수 있습니다. 현재 분석 공급자가 없는 경우 Fathom Analytics를 확인해 보세요.
Fathom Analytics #
Fathom Analytics는 구글 애널리틱스에 대한 개인정보 보호 서비스입니다. 이는 방문자 정보를 모두 얻을 수 있지만 그들을 스파이하지 않습니다. Congo 사용자는 이 관계 링크를 통해 10달러 크레딧을 받아 서비스를 시도할 수 있습니다.
Fathom Analytics 지원을 활성화하려면 config/_default/params.toml 파일에 Fathom 사이트 코드를 간단히 제공하세요. 스크립트는 Fathom Analytics CDN에서 직접 사이트에 로드됩니다.
# config/_default/params.toml
[fathomAnalytics]
site = "ABC12345"
Plausible Analytics #
Plausible Analytics 지원을 활성화하려면 config/_default/params.toml 파일에 원하는 추적 도메인을 간단히 제공하세요. 자체 호스팅 Plausible 또는 프록시 분석 스크립트 및 이벤트 API 라우터를 사용하려는 경우 추가 event 및 script 구성 값을 제공할 수도 있습니다. 이 두 값을 제공하지 않으면 스크립트가 직접 Plausible의 기본 관리 서비스와 함께 로드됩니다. 자세한 내용은 분석 프록시 사용을 참조하세요.
# config/_default/params.toml
[plausibleAnalytics]
domain = "blog.yoursite.com"
event = "https://plausible.yoursite.com/api/event"
script = "https://plausible.yoursite.com/js/script.js"
Umami Analytics #
Umami Analytics 지원을 활성화하려면 config/_default/params.toml 파일에 Umami 제공 추적 코드 토큰을 site 매개변수에 삽입하세요. 또한 region 매개변수를 삽입하여 Umami Analytics 서버의 지역을 나타낼 수도 있습니다. 이 값은 eu 또는 us일 수 있습니다. 자세한 내용은 umami.is/docs/getting-started을 참조하세요.
# config/_default/params.toml
[umamiAnalytics]
site = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
region = "eu" # can be either "eu" or "us"
Google Analytics #
Google Analytics 지원은 내부 Hugo 조각을 통해 제공됩니다. 간단히 config/_default/config.toml 파일에 googleAnalytics 키를 제공하세요. 이 키는 자동으로 스크립트를 추가합니다.
두 가지 버전(버전 3(analytics.js) 및 버전 4(gtag.js))이 지원되며, 제공된 구성 값에 따라 달라집니다.
# config/_default/config.toml
# version 3
googleAnalytics = "UA-PROPERTY_ID"
# version 4
googleAnalytics = "G-MEASUREMENT_ID"
사용자 정의 분석 공급자 #
사이트에 다른 분석 공급자를 사용하려면 또한 분석 조각을 재정의하고 자체 스크립트를 제공할 수 있습니다. 간단히 layouts/partials/analytics.html 파일을 프로젝트에 만들고 이는 사이트의 <head>에 자동으로 포함됩니다.
댓글 #
문서에 댓글을 추가하려면 Congo는 각 문서 페이지의 기본 부분을 포함하는 댓글 부분을 지원합니다. 간단히 layouts/partials/comments.html 파일을 프로젝트에 만들고 이는 사이트의 문서 페이지에 자동으로 포함됩니다.
내장된 Hugo Disqus 템플릿을 사용하거나 자체 사용자 지정 코드를 제공할 수 있습니다. 자세한 내용은 Hugo 문서를 참조하세요.
분석 조각이 제공되면 댓글이 표시되는 위치에 대한 더 많은 제어는 showComments 매개변수를 사용하여 관리됩니다. 이 값은 params.toml 구성 파일에서 테마 수준에서 또는 문서 기준으로 설정할 수 있습니다. 매개변수는 기본값이 false이므로 댓글이 표시되도록 하려면 이 위치 중 하나에서 true로 설정해야 합니다.
파비콘 #
Congo는 시작하기 위한 빈 파비콘 세트를 제공하지만 자체 자산을 제공하여 대체할 수 있습니다. 새 파비콘 자산을 얻는 가장 쉬운 방법은 favicon.io와 같은 타사 공급자를 사용하여 생성하는 것입니다.
아이콘 자산은 웹사이트의 static/ 폴더에 직접 배치되어야 하며, 아래 목록에 따라 이름을 지정해야 합니다. favicon.io를 사용하는 경우 이는 자동으로 생성된 파일 이름이지만, 원하는 경우 자산을 제공할 수 있습니다.
static/
├─ android-chrome-192x192.png
├─ android-chrome-512x512.png
├─ apple-touch-icon.png
├─ favicon-16x16.png
├─ favicon-32x32.png
├─ favicon.ico
└─ site.webmanifest
또한 기본 파비콘 동작을 완전히 재정의하고 자체 파비콘 HTML 태그와 자산을 제공할 수 있습니다. 간단히 layouts/partials/favicons.html 파일을 프로젝트에 만들고 이는 기본 자산 대신 사이트의 <head>에 자동으로 포함됩니다.
아이콘 #
아이콘 짧코드와 유사하게, 자체 템플릿과 부분에서 Congo의 icon.html 부분을 사용하여 아이콘을 포함할 수 있습니다. 부분은 포함할 아이콘의 이름을 하나의 매개변수로 사용합니다.
예시:
{{ partial "icon.html" "github" }}
아이콘은 Hugo 파이프라인을 사용하여 매우 유연하게 채워집니다. Congo는 소셜, 링크 및 기타 용도를 위한 많은 기본 아이콘을 포함합니다. 지원되는 아이콘 전체 목록은 아이콘 샘플 페이지를 참조하세요.
사용자 정의 아이콘은 프로젝트의 assets/icons/ 디렉토리에 자산을 제공하여 추가할 수 있습니다. 이 후 부분에서 아이콘을 참조할 때 .svg 확장자 없이 SVG 파일 이름을 사용할 수 있습니다.
아이콘은 또한 아이콘 짧코드를 호출하여 문서 콘텐츠에서 사용할 수 있습니다.
확장 #
Congo는 기본 기능을 확장하기 위한 여러 확장 부분을 제공합니다.
글 링크 #
글 링크 뒤에 추가 코드를 삽입하려면 layouts/partials/extend-article-link.html 파일을 만듭니다. 이는 badge 짧코드와 함께 사용할 때 특히 강력합니다. 이는 특정 글에 대한 메타데이터를 강조할 수 있습니다.
헤더와 푸터 #
템플릿의 <head>와 <footer> 섹션에 추가 코드를 삽입할 수 있습니다. 이는 테마의 일부가 아닌 스크립트 또는 기타 논리를 제공하는 데 유용합니다.
간단히 layouts/partials/extend-head.html 또는 layouts/partials/extend-footer.html 파일을 만들고 이는 사이트 빌드에 자동으로 포함됩니다. 두 부분은 <head>와 <footer>의 마지막 항목으로 주입되므로 테마 기본값을 재정의할 수 있습니다.